home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 151-175 / scopedisk168 / tinytools / pform / pform.man < prev    next >
Text File  |  1995-03-19  |  2KB  |  43 lines
  1.  
  2. NAME
  3.        PForm - Pipe formatted lines.
  4.  
  5.  
  6. SYNOPSIS
  7.        PForm "prefix %[flags][width.limit]s postfix"
  8.  
  9.  
  10. REQUIREMENTS
  11.        The ARP library
  12.  
  13.  
  14. DESCRIPTION
  15.        PForm reads lines from the standard input, formats them to your
  16.        specifications, and writes them to the standard output.
  17.        The formatting is done using exec's DoRawFmt. This is C like string
  18.        formatting. See programmer manuals for additional information.
  19.        What matters here is that PForm outputs its argument line string
  20.        for every input line, and it replaces every occurrence of %s in the
  21.        argument line string with the current input line.
  22.        The "width" argument specifies the fieldsize used when inserting the
  23.        input line into the string, and "limit" specifies the maximum number
  24.        of characters copied from the input line while inserting.
  25.        The only valid flag is "-" which specifies left justification.
  26.        You may use %s upto 20 times in a single format string.
  27.        To get a single "%" use "%%".
  28.        The main use for PForm lies in reformatting the output of commands.
  29.  
  30.  
  31. EXAMPLES
  32.        Alias Kill Status \| Search STDIN [] NONUM \| PForm "Break%11.10s" \| Execute
  33.        This alias will break the process with the name you specify. You
  34.        no longer need to specify the process number.
  35.  
  36.        List [] NOHEAD QUICK | PForm "Rename %s %s.old" | Execute
  37.        Give commands wildcarding properties.
  38.  
  39.  
  40. BUGS/LIMITATIONS
  41.        How to apply PForm to the output of a command depends on the specific
  42.        format of its output. You'd better experiment.
  43.